38 plotly

Uncomment the following line to install leafmap if needed.

In [1]:

# !pip install leafmap

# !pip install leafmap

In [2]:

import leafmap.plotlymap as leafmap

import leafmap.plotlymap as leafmap

If you run into an error saying "FigureWidget - 'mapbox._derived' Value Error" (source), uncomment the following line and run it.

In [3]:

# leafmap.fix_widget_error()

# leafmap.fix_widget_error()

Create an interactive map using default settings.

In [4]:

m = leafmap.Map()
m

m = leafmap.Map() m

Change default setting when creating a map.

Can be one of string from "open-street-map", "carto-positron", "carto-darkmatter", "stamen-terrain", "stamen-toner" or "stamen-watercolor" .

In [5]:

m = leafmap.Map(center=(40, -100), zoom=3, basemap="stamen-terrain", height=500)
m

m = leafmap.Map(center=(40, -100), zoom=3, basemap="stamen-terrain", height=500) m

Set map center and zoom level.

In [6]:

m = leafmap.Map(basemap="stamen-watercolor")
m.set_center(lat=20, lon=0, zoom=2)
m

m = leafmap.Map(basemap="stamen-watercolor") m.set_center(lat=20, lon=0, zoom=2) m

Print out available basemaps.

In [7]:

leafmap.basemaps.keys()

leafmap.basemaps.keys()

Out[7]:

dict_keys(['OpenStreetMap', 'ROADMAP', 'SATELLITE', 'TERRAIN', 'HYBRID', 'BasemapAT.basemap', 'BasemapAT.grau', 'BasemapAT.highdpi', 'BasemapAT.orthofoto', 'BasemapAT.overlay', 'BasemapAT.surface', 'BasemapAT.terrain', 'CartoDB.DarkMatter', 'CartoDB.DarkMatterNoLabels', 'CartoDB.DarkMatterOnlyLabels', 'CartoDB.Positron', 'CartoDB.PositronNoLabels', 'CartoDB.PositronOnlyLabels', 'CartoDB.Voyager', 'CartoDB.VoyagerLabelsUnder', 'CartoDB.VoyagerNoLabels', 'CartoDB.VoyagerOnlyLabels', 'CyclOSM', 'Esri.AntarcticBasemap', 'Esri.ArcticOceanBase', 'Esri.ArcticOceanReference', 'Esri.DeLorme', 'Esri.NatGeoWorldMap', 'Esri.OceanBasemap', 'Esri.WorldGrayCanvas', 'Esri.WorldImagery', 'Esri.WorldPhysical', 'Esri.WorldShadedRelief', 'Esri.WorldStreetMap', 'Esri.WorldTerrain', 'Esri.WorldTopoMap', 'FreeMapSK', 'Gaode.Normal', 'Gaode.Satellite', 'GeoportailFrance.orthos', 'GeoportailFrance.parcels', 'GeoportailFrance.plan', 'HikeBike.HikeBike', 'HikeBike.HillShading', 'JusticeMap.americanIndian', 'JusticeMap.asian', 'JusticeMap.black', 'JusticeMap.hispanic', 'JusticeMap.income', 'JusticeMap.multi', 'JusticeMap.nonWhite', 'JusticeMap.plurality', 'JusticeMap.white', 'MtbMap', 'NASAGIBS.BlueMarble', 'NASAGIBS.BlueMarble3031', 'NASAGIBS.BlueMarble3413', 'NASAGIBS.ModisAquaBands721CR', 'NASAGIBS.ModisAquaTrueColorCR', 'NASAGIBS.ModisTerraAOD', 'NASAGIBS.ModisTerraBands367CR', 'NASAGIBS.ModisTerraBands721CR', 'NASAGIBS.ModisTerraChlorophyll', 'NASAGIBS.ModisTerraLSTDay', 'NASAGIBS.ModisTerraSnowCover', 'NASAGIBS.ModisTerraTrueColorCR', 'NASAGIBS.ViirsEarthAtNight2012', 'NASAGIBS.ViirsTrueColorCR', 'NLS', 'OPNVKarte', 'OneMapSG.Default', 'OneMapSG.Grey', 'OneMapSG.LandLot', 'OneMapSG.Night', 'OneMapSG.Original', 'OpenAIP', 'OpenFireMap', 'OpenRailwayMap', 'OpenSeaMap', 'OpenSnowMap.pistes', 'OpenStreetMap.BZH', 'OpenStreetMap.BlackAndWhite', 'OpenStreetMap.CH', 'OpenStreetMap.DE', 'OpenStreetMap.France', 'OpenStreetMap.HOT', 'OpenStreetMap.Mapnik', 'OpenTopoMap', 'SafeCast', 'Stadia.AlidadeSmooth', 'Stadia.AlidadeSmoothDark', 'Stadia.OSMBright', 'Stadia.Outdoors', 'Stamen.Terrain', 'Stamen.TerrainBackground', 'Stamen.TerrainLabels', 'Stamen.Toner', 'Stamen.TonerBackground', 'Stamen.TonerHybrid', 'Stamen.TonerLabels', 'Stamen.TonerLines', 'Stamen.TonerLite', 'Stamen.TopOSMFeatures', 'Stamen.TopOSMRelief', 'Stamen.Watercolor', 'Strava.All', 'Strava.Ride', 'Strava.Run', 'Strava.Water', 'Strava.Winter', 'SwissFederalGeoportal.JourneyThroughTime', 'SwissFederalGeoportal.NationalMapColor', 'SwissFederalGeoportal.NationalMapGrey', 'SwissFederalGeoportal.SWISSIMAGE', 'USGS.USImagery', 'USGS.USImageryTopo', 'USGS.USTopo', 'WaymarkedTrails.cycling', 'WaymarkedTrails.hiking', 'WaymarkedTrails.mtb', 'WaymarkedTrails.riding', 'WaymarkedTrails.skating', 'WaymarkedTrails.slopes', 'nlmaps.grijs', 'nlmaps.luchtfoto', 'nlmaps.pastel', 'nlmaps.standaard', 'nlmaps.water'])

Add a basemap.

In [8]:

m = leafmap.Map()
m.add_basemap("OpenTopoMap")
m

m = leafmap.Map() m.add_basemap("OpenTopoMap") m

Add XYZ tile layer.

In [9]:

m = leafmap.Map()
tile_url = "https://mt1.google.com/vt/lyrs=y&x={x}&y={y}&z={z}"
m.add_tile_layer(tile_url, name="Google Satellite", attribution="Google", opacity=1.0)
m

m = leafmap.Map() tile_url = "https://mt1.google.com/vt/lyrs=y&x={x}&y={y}&z={z}" m.add_tile_layer(tile_url, name="Google Satellite", attribution="Google", opacity=1.0) m

Add a mapbox tile layer. You will need a mapbox token. The map style can be Can be "basic", "streets", "outdoors", "light", "dark", "satellite", or "satellite-streets".

In [10]:

import os

import os

In [11]:

# os.environ["MAPBOX_TOKEN"] = "your-mapbox-token"

# os.environ["MAPBOX_TOKEN"] = "your-mapbox-token"

In [12]:

m = leafmap.Map()
m.add_mapbox_layer(style="streets")
m

m = leafmap.Map() m.add_mapbox_layer(style="streets") m

Remove the modebar in the upper-right corner.

In [13]:

m = leafmap.Map(basemap="stamen-toner")
m

m = leafmap.Map(basemap="stamen-toner") m

In [14]:

m.clear_controls()

m.clear_controls()

Add more buttons to the modebar.

In [15]:

m = leafmap.Map(basemap="carto-positron")
controls = [
    'drawline',
    'drawopenpath',
    'drawclosedpath',
    'drawcircle',
    'drawrect',
    'eraseshape',
]
m.add_controls(controls)
m

m = leafmap.Map(basemap="carto-positron") controls = [ 'drawline', 'drawopenpath', 'drawclosedpath', 'drawcircle', 'drawrect', 'eraseshape', ] m.add_controls(controls) m

Add Cloud Optimized GeoTIFF.

In [16]:

m = leafmap.Map()
url = 'https://opendata.digitalglobe.com/events/california-fire-2020/pre-event/2018-02-16/pine-gulch-fire20/1030010076004E00.tif'
m.add_cog_layer(url, name="Fire (pre-event)")
m

m = leafmap.Map() url = 'https://opendata.digitalglobe.com/events/california-fire-2020/pre-event/2018-02-16/pine-gulch-fire20/1030010076004E00.tif' m.add_cog_layer(url, name="Fire (pre-event)") m

Add a STAC item via HTTP URL.

In [17]:

m = leafmap.Map()
url = 'https://canada-spot-ortho.s3.amazonaws.com/canada_spot_orthoimages/canada_spot5_orthoimages/S5_2007/S5_11055_6057_20070622/S5_11055_6057_20070622.json'
m.add_stac_layer(url, bands=['B3', 'B2', 'B1'], name='False color')
m

m = leafmap.Map() url = 'https://canada-spot-ortho.s3.amazonaws.com/canada_spot_orthoimages/canada_spot5_orthoimages/S5_2007/S5_11055_6057_20070622/S5_11055_6057_20070622.json' m.add_stac_layer(url, bands=['B3', 'B2', 'B1'], name='False color') m

Add a STAC item from Microsoft Planetary Computer.

In [18]:

collection = "landsat-8-c2-l2"
item = "LC08_L2SP_047027_20201204_02_T1"

collection = "landsat-8-c2-l2" item = "LC08_L2SP_047027_20201204_02_T1"

In [19]:

m = leafmap.Map()
m.add_stac_layer(
    collection=collection,
    item=item,
    bands=["SR_B7", "SR_B5", "SR_B4"],
    titiler_endpoint="pc",
)
m

m = leafmap.Map() m.add_stac_layer( collection=collection, item=item, bands=["SR_B7", "SR_B5", "SR_B4"], titiler_endpoint="pc", ) m

Add a heat map.

In [20]:

url = 'https://raw.githubusercontent.com/plotly/datasets/master/earthquakes-23k.csv'

url = 'https://raw.githubusercontent.com/plotly/datasets/master/earthquakes-23k.csv'

In [21]:

m = leafmap.Map(basemap="stamen-terrain")
m.add_heatmap(
    url, latitude="Latitude", longitude="Longitude", z="Magnitude", name="Earthquake"
)
m

m = leafmap.Map(basemap="stamen-terrain") m.add_heatmap( url, latitude="Latitude", longitude="Longitude", z="Magnitude", name="Earthquake" ) m

Add a choropleth map.

In [22]:

url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson"

url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson"

In [23]:

m = leafmap.Map(basemap="stamen-terrain")
m.add_choropleth_map(url, name="Pop", z="POP_EST", colorscale="Viridis")
m

m = leafmap.Map(basemap="stamen-terrain") m.add_choropleth_map(url, name="Pop", z="POP_EST", colorscale="Viridis") m

---

Last update: 2022-06-07